home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / hobby / gim_308.zip / GIM11D.DOC < prev    next >
Text File  |  1995-02-07  |  43KB  |  999 lines

  1.           CHAPTER 11     LISTS OF SIMILAR PERSONS, FAMILIES AND NOTES
  2.  
  3.                                       OR
  4.  
  5.           SEARCHING YOUR FOLDER FOR SPECIFIC INFORMATION
  6.  
  7.  
  8. PART D:  OPERANDS USED IN WHERE COMMANDS...
  9.  
  10.           In this section we assume that you know what a WHERE command
  11.           is, how it's used, and what it's used for.  We also assume
  12.           that you know what operators and operands in WHERE commands
  13.           are, and how they are used.  If you haven't done so already,
  14.           review the first section in this chapter, which is entitled
  15.           "An Introduction with Basic Examples", and skim the section
  16.           entitled "Operators Used in WHERE Commands".
  17.  
  18.           The WHERE command provides a number of operands.  These can
  19.           be broken into two major categories, as follows:
  20.  
  21.                1.  Constants, such as "4 July 1776" or "George"
  22.                2.  Variables, such as BIRTH DATE or SURNAME
  23.  
  24.           We'll discuss constants first, because they can be explained
  25.           quickly.  Then we'll turn our attention to the many variable
  26.           operands that are available, and discuss them each in detail.
  27.  
  28.           CONSTANT OPERANDS:
  29.  
  30.           Constant operands come in three flavors:
  31.  
  32.                1.  String constants, such as "Posen, Poland"
  33.                2.  Numeric constants, such as 5, or 12
  34.                3.  Date constants, such as 1776, or "4 Jul 1776"
  35.  
  36.           We'll present each of these in turn.
  37.  
  38. STRINGS...
  39.  
  40.           STRING CONSTANTS:
  41.  
  42.                String constants must always be enclosed by quotation
  43.                marks, no matter whether the string constant is a single
  44.                word, or several words.
  45.  
  46.                Examples of valid string constants:
  47.  
  48.                     "microfilm"
  49.                     "George Washington"
  50.                     "Durup, Viborg, Denmark"
  51.                     "" -- but see note 3.
  52.  
  53.                Examples of invalid string constants:
  54.  
  55.                     microfilm
  56.                     George Washington
  57.                     Durup, Viborg, Denmark
  58.  
  59.                Examples of the correct use of string constants:
  60.  
  61.                     WHERE surname is "Washington"
  62.                     WHERE any place contains "Czechoslovakia"
  63.                     WHERE birth source note contains "microfilm"
  64.  
  65.                Notes about the use of string constants:
  66.  
  67.                     1.  String searches may be either CASE SENSITIVE or
  68.                         CASE INSENSITIVE.  "CASE SENSITIVE" means that
  69.                         a search for "Poland" is quite different from a
  70.                         search for "poland" or "POLAND".
  71.  
  72.                         Case sensitivity can be turned on or off; see
  73.                         the section entitled "A Glossary of GIM LISTS
  74.                         Commands with Examples", under the heading
  75.                         CASESENS, for details.
  76.  
  77.                     2.  The fact that string constants are delimited by
  78.                         quotation marks means that string constants
  79.                         cannot contain quotation marks.  In other
  80.                         words, it is not possible for to search for
  81.                         this place name ...
  82.  
  83.                         ship "U.S.S. Wyoming"
  84.  
  85.                         ... because the following construction is
  86.                         illegal:
  87.  
  88.                         WHERE birth place is "ship "U.S.S. Wyoming""
  89.  
  90.                         To get around this, use some variation on the
  91.                         following...
  92.  
  93.                         WHERE birth place contains "U.S.S. Wyoming"
  94.  
  95.                         ... and then harass me until I get this fixed!
  96.  
  97.                     3.  The string constant "" is legal, but it is best
  98.                         avoided.  The command ...
  99.  
  100.                         WHERE birth place contains ""
  101.  
  102.                         ... is more clearly expressed as ...
  103.  
  104.                         WHERE birth place isn't missing
  105.  
  106.                         ... and the command ...
  107.  
  108.                         WHERE birth place is ""
  109.  
  110.                         ... is more clearly expressed as ...
  111.  
  112.                         WHERE birth place is missing
  113.  
  114.                         It is therefore best to avoid the use of ""
  115.                         whenever possible.
  116.  
  117. NUMBERS...
  118.  
  119.           NUMERIC CONSTANTS:
  120.  
  121.                Unlike string constants, numeric constants must not be
  122.                enclosed by quotation marks.
  123.  
  124.                Examples of valid numeric constants:
  125.  
  126.                -5
  127.                12
  128.                14000000
  129.  
  130.                Examples of invalid numeric constants:
  131.  
  132.                "-5"
  133.                "12"
  134.                "14000000"
  135.                3.5                          -- see note 1 below
  136.                1234123412341234123412341234 -- see note 2 below
  137.  
  138.                Examples of the correct use of numeric constants:
  139.  
  140.                     WHERE spouses ge 2
  141.                     WHERE children gt 5 and children lt 9
  142.                     WHERE gin gt 0
  143.  
  144.                Notes about the use of numeric constants:
  145.  
  146.                     1.  Numeric constants must be integers.  It should
  147.                         never be necessary to use real numbers in WHERE
  148.                         commands; if you find an exception, please let
  149.                         me know!
  150.  
  151.                     2.  Numeric constants must fall in the range of
  152.                         integers from -2147483647 to 2147483647.
  153.  
  154. DATES...
  155.  
  156.           DATE CONSTANTS:
  157.  
  158.                Date constants should always be enclosed in quotation
  159.                marks.  You may omit them if the date constant is a
  160.                single, four-digit number, representing a year, such as
  161.                1776.  In this case, it doesn't hurt to include them.
  162.                In all other cases, they must be included.
  163.  
  164.                Examples of valid date constants:
  165.  
  166.                     "30 Apr 1964"
  167.                     "30 April 1964"
  168.                     "4 Jul 1776"
  169.                     "1776"
  170.                     1776
  171.  
  172.                Examples of invalid date constants:
  173.  
  174.                     3 March 1964 -- see note 1.
  175.                     984          -- see note 2.
  176.                     "infant"     -- see note 4.
  177.  
  178.                Examples of the correct use of date constants:
  179.  
  180.                     WHERE birth date is after "1 Mar 1881"
  181.                     WHERE birth date is before 1500
  182.                     WHERE marriage date is "15 Jun 1961"
  183.  
  184.                Notes about the use of date constants:
  185.  
  186.                     1.  As has been stated, any date constant that
  187.                         isn't a simple year must be enclosed in
  188.                         quotation marks.
  189.  
  190.                     2.  If a date constant is a simple year, it must be
  191.                         exactly four digits, or else it must be
  192.                         enclosed in quotation marks.
  193.  
  194.                     3.  If a date constant is a simple year, such as
  195.                         1920, it is interpreted as a point in time
  196.                         between 1919 and 1920.  Therefore, searching
  197.                         for dates ON OR BEFORE 1920 will NOT include
  198.                         dates IN 1920; on the other hand, searching for
  199.                         dates ON OR AFTER 1920 WILL include dates IN
  200.                         1920.  For this reason, unless you are being
  201.                         deliberately general in your search, it is
  202.                         always best to include a month and day in your
  203.                         date constants, such as "31 Dec 1920".
  204.  
  205.                     4.  As a matter of fact, "infant" is legal, but
  206.                         meaningless.  Date constants are used by date
  207.                         operators to represent a point in time.  The
  208.                         constant "infant" is equivalent to "no time",
  209.                         and results in unpredictable behavior.  If you
  210.                         want to compare dates with strings of charac-
  211.                         ters, use string operators instead of date
  212.                         operators.  In that case, "infant" becomes a
  213.                         legal string constant, rather than a date
  214.                         constant; in that case, the value of "infant"
  215.                         has meaning.
  216.  
  217. VARIABLES...
  218.  
  219.           VARIABLE OPERANDS:
  220.  
  221.           Variable operands come in three flavors:
  222.  
  223.                1.  Those that stand on their own, such as PIN, GIN,
  224.                    SURNAME, SPOUSES, or AFN.  These are the most basic
  225.                    kind of variable operand, and take no modifiers.
  226.                    These will be discussed below, in a section entitled
  227.                    "Basic Variables".
  228.  
  229.                2.  Those that are modified with ANY or ALL, such as ANY
  230.                    PLACE or ANY RESEARCH NOTE or ANY VITALS PLACE.
  231.                    These are more involved, and will be discussed below
  232.                    in a section entitled "Modifier Variables".
  233.  
  234.                3.  Those that point to other variables, such as MOTHER
  235.                    or CHILD.  These will require some explaining, which
  236.                    will be done in a section below entitled "Pointer
  237.                    Variables".
  238.  
  239.           Each of these three flavors will be discussed in turn, in its
  240.           own subsection, after which all of the variable operands will
  241.           be presented in a diagram which should hopefully tie all of
  242.           this together.
  243.  
  244.           BASIC VARIABLES...
  245.  
  246.                Variables in this section are simple, one-word operands
  247.                that need little explanation.
  248.  
  249.                Each operand in this section will be followed by four or
  250.                five lines of description, as follows:
  251.  
  252.                List Type:
  253.  
  254.                     "Persons", "Families", "Notes", or "Persons and
  255.                     Families", depending on which types of lists may be
  256.                     created with this operand.
  257.  
  258.                     It doesn't make sense, for example, to use the PIN
  259.                     or GIN operands, which are person-related operands,
  260.                     when generating a list of families, so you will see
  261.                     "List Type:  Persons" beneath these operands.
  262.  
  263.                     However, the CHILDREN operator has meaning (albeit
  264.                     a slightly different one in each case) for both
  265.                     lists of Persons and lists of Families, so you will
  266.                     see "List Type: Persons and Families" beneath
  267.                     operands like this one.
  268.  
  269.                Operand Type:
  270.  
  271.                     Date, Number, String, and/or Note, depending on
  272.                     which type(s) of operator(s) make(s) sense with
  273.                     this operand.  It doesn't make sense, for example,
  274.                     to use the "contains" operator, which is a string
  275.                     operator, with the FIN operand, which is a number.
  276.  
  277.                Meaning:
  278.  
  279.                     A summary in English of the concept that the
  280.                     operand's name represents.
  281.  
  282.                Example:
  283.  
  284.                     An example of the way the operand may be used.
  285.  
  286.                Notes:
  287.  
  288.                     If there is anything potentially confusing or
  289.                     unusual about the use of this operand, it will be
  290.                     clarified here.
  291.  
  292.                The basic variable operands are as follows:
  293.  
  294.                AFN:
  295.                     List Type:  Persons
  296.                     Operand Type:  String
  297.                     Meaning:  The person's Ancestral File Number
  298.                     Example:  WHERE afn is "HRVP-BD"
  299.  
  300.                CHILDREN:
  301.                     List Type:  Persons or Families
  302.                     Operand Type:  Number
  303.                     Meaning:  For persons:
  304.                                    The person's number of children by
  305.                                    all spouses
  306.                               For families:
  307.                                    The family's number of children
  308.                     Example:  WHERE children ge 12
  309.  
  310.                CODE:
  311.                     List Type:  Persons
  312.                     Operand Type:  String
  313.                     Meaning:  The person's "code" value.
  314.                     Example:  WHERE code isn't missing
  315.  
  316.                FIN:
  317.                     List Type:  Families
  318.                     Operand Type:  Number
  319.                     Meaning:  The family's FIN number.
  320.                     Example:  WHERE FIN gt 1000
  321.  
  322.                FIRST:
  323.                     List Type:  Persons
  324.                     Operand Type:  String
  325.                     Meaning:  The person's first name
  326.                     Example:  WHERE first is "Johannes"
  327.                     Notes:  1. See also GIVEN, a synonym for FIRST.
  328.                             2. FIRST takes on an entirely different
  329.                                meaning when used as a modifier, as in
  330.                                FIRST SPOUSE or FIRST CHILD.  This usage
  331.                                is described below, in the section
  332.                                entitled "Modifier Variables".
  333.  
  334.                FULL:
  335.                     List Type:  Persons
  336.                     Operand Type:  String
  337.                     Meaning:  The person's full name
  338.                     Example:  WHERE full is "George Washington"
  339.  
  340.                GENDER:
  341.                     List Type:  Persons
  342.                     Operand Type:  String
  343.                     Meaning:  The person's gender as "M", "F", or "U"
  344.                     Example:  WHERE gender is "F"
  345.  
  346.                GIN:
  347.                     List Type:  Persons
  348.                     Operand Type:  Number
  349.                     Meaning:  The person's GIN number
  350.                     Example:  WHERE GIN ne 0
  351.  
  352.                GIVEN:
  353.                     List Type:  Persons
  354.                     Operand Type:  String
  355.                     Meaning:  The person's given name
  356.                     Example:  WHERE given contains "Maria"
  357.                     Notes:  See also FIRST, a synonym for GIVEN.
  358.  
  359.                LAST:
  360.                     List Type:  Persons
  361.                     Operand Type:  String
  362.                     Meaning:  The person's last name
  363.                     Example:  WHERE last is "Smith"
  364.                     Notes:  1. See also SURNAME, a synonym for LAST
  365.                             2. LAST takes on an entirely different
  366.                                meaning when used as a modifier, as in
  367.                                LAST SPOUSE or LAST CHILD.  This usage
  368.                                is described below, in the section
  369.                                entitled "Modifier Variables".
  370.  
  371.                NOTE:
  372.                     List Type:  Notes
  373.                     Operand Type:  Note
  374.                     Meaning:  The note in a list of notes
  375.                     Example:  WHERE note contains "Error in the IGI:"
  376.                     Notes:  NOTE takes on an entirely different meaning
  377.                             when used with modifiers, as in SOURCE NOTE
  378.                             or RESEARCH NOTE.  This usage is described
  379.                             below, in the section entitled "Modifier
  380.                             Variables".
  381.  
  382.                NUMPARENTS:
  383.                    List Type:  Persons
  384.                    Operand Type:  Number
  385.                    Meaning:  The person's number of parents
  386.                    Example:  WHERE parents eq 1 or parents eq 3
  387.                    Notes:  NUMPARENTS counts parents separately.  That
  388.                            is, if a person has two *sets* of parents,
  389.                            with a mother and father in each set, then
  390.                            the total value of NUMPARENTS will be 4.  If
  391.                            a person has a father and no mother, or vice
  392.                            versa, the value of NUMPARENTS will be 1.
  393.  
  394.                NUMPARENTSETS:
  395.                    List Type:  Persons
  396.                    Operand Type:  Number
  397.                    Meaning:  The person's number of sets of parents
  398.                    Example:  WHERE parentsets gt 1
  399.                    Notes:  NUMPARENTSETS counts parents in sets.  That
  400.                            is, if a person has two *sets* of parents,
  401.                            with a mother and father in each set, then
  402.                            the total value of NUMPARENTSETS will be 2,
  403.                            not 4.  If a person has a father and no
  404.                            mother, or vice versa, the value of
  405.                            NUMPARENTSETS will be 1.
  406.  
  407.                PIN:
  408.                     List Type:  Persons
  409.                     Operand Type:  Number
  410.                     Meaning:  The person's PIN number
  411.                     Example:  WHERE pin ge 4 and pin le 7
  412.  
  413.                REFN:
  414.                     List Type:  Persons
  415.                     Operand Type:  String
  416.                     Meaning:  The person's reference number value
  417.                     Example:  WHERE refn contains "PAF"
  418.  
  419.                SPOUSES:
  420.                     List Type:  Persons
  421.                     Operand Type:  Number
  422.                     Meaning:  The person's number of spouses
  423.                     Example:  WHERE spouses eq 2
  424.  
  425.                SURNAME:
  426.                     List Type:  Persons
  427.                     Operand Type:  String
  428.                     Meaning:  The person's last name
  429.                     Example:  WHERE surname is "Smith"
  430.                     Notes:  See also LAST, a synonym for SURNAME
  431.  
  432.           MODIFIER VARIABLES...
  433.  
  434.                Variables in this section are used to express thoughts
  435.                like "any place" or "first marriage date" or "all source
  436.                notes".  They can also get a little more involved, and
  437.                can be used to express thoughts like:
  438.  
  439.                     *  any LDS ordinance date
  440.                     *  all non-LDS, vital statistics places
  441.                     *  any marriage's research notes
  442.  
  443.                This section will explain how to translate these
  444.                thoughts into GIM LISTS variable operands.
  445.  
  446.                In order to do so, we first need to define three groups,
  447.                called GROUP A, GROUP B, and GROUP C.  Modifier
  448.                variables such as BIRTH and MARRIAGE are applied to
  449.                members of some or all of these groups.
  450.  
  451.                Let's define them first, before we go on:
  452.  
  453.                GROUP A:  DATE, PLACE, PLACEBEG or PLACEEND
  454.  
  455.                     DATE:
  456.                          Operand Type:  Date
  457.                          When the word "DATE" is used together with
  458.                          preceding keywords, like MARRIAGE or BIRTH,
  459.                          it represents the marriage date of a given
  460.                          family, or the birth date of a given person.
  461.                     PLACE:
  462.                          Operand Type:  String
  463.                          When the word "PLACE" is used together with
  464.                          preceding keywords, like MARRIAGE or BIRTH,
  465.                          it represents the marriage place of a given
  466.                          family, or the birth place of a given person.
  467.                     PLACEBEG:
  468.                          Operand Type:  Date
  469.                          This operator only makes sense with LDS events
  470.                          (baptism, endowment, and sealings).  When used
  471.                          together with preceding keywords, like SEALSP
  472.                          or ENDOWMENT, it represents the date that this
  473.                          event's temple opened.  For more details, see
  474.                          the section entitled "Advanced Examples;
  475.                          Arcane WHERE Command Syntax".
  476.                     PLACEEND:
  477.                          Operand Type:  Date
  478.                          This operator only makes sense with LDS events
  479.                          (baptism, endowment, and sealings).  When used
  480.                          together with preceding keywords, like SEALSP
  481.                          or ENDOWMENT, it represents the date that this
  482.                          event's temple closed.  For more details, see
  483.                          the section entitled "Advanced Examples;
  484.                          Arcane WHERE Command Syntax".
  485.  
  486.                GROUP B:  NOTE
  487.  
  488.                     Operand Type:  Note
  489.  
  490.                     In certain cases, usually with ANY or ALL, it is
  491.                     legal to refer to a "note" without specifying
  492.                     whether you mean a source or a research note.
  493.  
  494.                     GROUP B should be thought of as a special case of
  495.                     GROUP C, discussed below.
  496.  
  497.                GROUP C:  SOURCE NOTE or RESEARCH NOTE
  498.  
  499.                     SOURCE NOTE:
  500.                          Operand Type:  Note
  501.                          When the words "SOURCE NOTE" are used together
  502.                          with preceding keywords, like MARRIAGE or
  503.                          BIRTH, they represent the marriage source note
  504.                          of a given family, or the birth source note of
  505.                          a given person.
  506.                     RESEARCH NOTE:
  507.                          Operand Type:  Note
  508.                          When the words "RESEARCH NOTE" are used to-
  509.                          gether with preceding keywords, like MARRIAGE
  510.                          or BIRTH, they represent the marriage research
  511.                          note of a given family, or the birth research
  512.                          not of a given person.
  513.  
  514.                Now we'll list the variable operands that modify each of
  515.                these groups.  In these listings, the categories "List
  516.                Type", "Meaning", "Example" and "Notes" mean what they
  517.                did in the "Basic Variables" section above.  The
  518.                "Operand Type" category has been moved to the GROUP
  519.                definitions above, and a new category has been added;
  520.                the category "Followed by" means that a member of the
  521.                listed GROUPs may follow the listed operand.
  522.  
  523.                BAPTISM:
  524.                     List Type:  Persons
  525.                     Followed by:  GROUP A, GROUP C
  526.                     Meaning:  The person's LDS baptism event
  527.                     Example:  WHERE baptism source note contains "Living"
  528.  
  529.                BIRTH:
  530.                     List Type:  Persons
  531.                     Followed by:  GROUP A, GROUP C
  532.                     Meaning:  The person's birth event
  533.                     Example:  WHERE birth date is after 1945
  534.  
  535.                BURIAL:
  536.                     List Type:  Persons
  537.                     Followed by:  GROUP A, GROUP C
  538.                     Meaning:  The person's burial event
  539.                     Example:  WHERE burial date is before death date
  540.  
  541.                CHRISTENING:
  542.                     List Type:  Persons
  543.                     Followed by:  GROUP A, GROUP C
  544.                     Meaning:  The person's christening event
  545.                     Example:  WHERE christening date is birth date
  546.  
  547.                DEATH:
  548.                     List Type:  Persons
  549.                     Followed by:  GROUP A, GROUP C
  550.                     Meaning:  The person's death event
  551.                     Example:  WHERE death date is burial date
  552.  
  553.                ENDOWMENT:
  554.                     List Type:  Persons
  555.                     Followed by:  GROUP A, GROUP C
  556.                     Meaning:  The person's LDS endowment event
  557.                     Example:  WHERE endowment place contains "New Zealand"
  558.  
  559.                GENERAL:
  560.                     List Type:  Persons or Families
  561.                     Followed by:  GROUP C
  562.                     Meaning:  Person's or Family's miscellaneous notes
  563.                     Example:  WHERE general source note contains "SSN"
  564.  
  565.                MARRIAGE:
  566.                     List Type:  Persons or Families
  567.                     Followed by:  GROUP A, GROUP C
  568.                     Meaning:  For persons:
  569.                                    The person's "selected" marriage
  570.                                    event; see chapter 4 for details
  571.                               For families:
  572.                                    The family's marriage event
  573.                     Example:  WHERE marriage date is sealsp date
  574.  
  575.                SEALPAR:
  576.                     List Type:  Persons
  577.                     Followed by:  GROUP A, GROUP C
  578.                     Meaning:  The person's LDS sealing to parents event
  579.                     Example:  WHERE sealpar place contains "New Zealand"
  580.  
  581.                SEALSP:
  582.                     List Type:  Families
  583.                     Followed by:  GROUP A, GROUP C
  584.                     Meaning:  For persons:
  585.                                    The person's "selected" sealing to
  586.                                    spouse event; see chapter 4 for
  587.                                    details
  588.                               For families:
  589.                                    The family's sealing to spouse event
  590.                     Example:  WHERE sealsp place contains "New Zealand"
  591.  
  592.                Now, we can modify these variables even more, by using
  593.                modifiers like "ANY" and "ALL", to select "any place" or
  594.                "all dates".
  595.  
  596.                There are five of these modifiers:
  597.  
  598.                     ANY:  Select any member of the group
  599.                     ALL:  Select all members of the group
  600.                     FIRST:  Select the first member of the group
  601.                     NUMBER #:  Select the #th member of the group
  602.                     LAST:  Select the last member of the group
  603.  
  604.                These may be used in any of five different situations:
  605.  
  606.                     ANY/ALL VITAL:
  607.  
  608.                          This situation applies only to lists of
  609.                          persons.
  610.  
  611.                          "VITAL" events are non-LDS vital statistics;
  612.                          specifically, birth, christening, death,
  613.                          burial, and any and all marriages.
  614.  
  615.                          We can combine ANY or ALL with VITAL to select
  616.                          these vital statistics.  For example ...
  617.  
  618.                          MAKE Germans
  619.                          FROM All Persons
  620.                          WHERE any vital place contains "Germany"
  621.  
  622.                          ... will select any persons who have "Germany"
  623.                          in their vital statistics, no matter whether
  624.                          that place name is in the birth, or death, or
  625.                          one of their marriages.  By contrast, this ...
  626.  
  627.                          WHERE all vital places contain "Germany"
  628.  
  629.                          ... requires that ALL of the vital statistics
  630.                          places must contain the word "Germany" (or be
  631.                          empty).
  632.  
  633.                          Note that VITALS and VITAL may be used inter-
  634.                          changeably, and so can PLACE and PLACES.  This
  635.                          helps keeps WHERE commands from sounding
  636.                          awkward.
  637.  
  638.                     ANY/ALL LDS:
  639.  
  640.                          This situation applies only to lists of
  641.                          persons.
  642.  
  643.                          This situation is just like ANY/ALL VITALS
  644.                          above, except that it refers only to the LDS
  645.                          events:  baptism, endowment, sealing to
  646.                          parents, and any and all sealings to spouses.
  647.  
  648.                          For example, this ...
  649.  
  650.                          WHERE any lds place doesn't contain "Temple"
  651.  
  652.                          ... selects LDS places outside of temples,
  653.                          such as living baptisms or Endowment House
  654.                          sealings.
  655.  
  656.                     ANY/ALL/FIRST/NUMBER/LAST MARRIAGE:
  657.  
  658.                          This situation applies only to lists of
  659.                          persons.
  660.  
  661.                          This situation is just like ANY/ALL VITALS
  662.                          above, except that it only refers to the set
  663.                          of any and all of a person's marriages.
  664.  
  665.                          For example, this ...
  666.  
  667.                          WHERE death date is before first marriage date
  668.  
  669.                          ... selects persons who died before their
  670.                          first marriage.
  671.  
  672.                     ANY/ALL/FIRST/NUMBER/LAST SEALSP:
  673.  
  674.                          This situation applies only to lists of
  675.                          persons.
  676.  
  677.                          This situation is just like ANY/ALL LDS above,
  678.                          except that it only refers to the set of any
  679.                          and all of a person's sealings to spouses.
  680.  
  681.                     ANY/ALL:
  682.  
  683.                          This situation applies only to lists of
  684.                          families.
  685.  
  686.                          This situation refers to the marriage and
  687.                          sealing to spouse event, taken together.
  688.  
  689.                          In other words, the command ...
  690.  
  691.                          MAKE Microfilms
  692.                          FROM All Families
  693.                          WHERE any source note contains "microfilm"
  694.  
  695.                          ... will select families if the word microfilm
  696.                          appears in either the marriage source note or
  697.                          in the sealing to spouse source note.  By
  698.                          contrast, this ...
  699.  
  700.                          WHERE all source notes contain "microfilm"
  701.  
  702.                          ... will select families if the word microfilm
  703.                          appears in BOTH the marriage source note AND
  704.                          in the sealing to spouse source note.
  705.  
  706.           POINTER VARIABLES...
  707.  
  708.                Variables in this section are potentially confusing, and
  709.                they may take some time to fully understand.  However,
  710.                they serve an important, useful and powerful function,
  711.                and you will thank me for encouraging you to spend time
  712.                learning about them.
  713.  
  714.                Suppose you are searching through the list of All
  715.                Persons for persons with the name "David".  You would do
  716.                that with the following set of GIM LISTS commands:
  717.  
  718.                     MAKE Davids
  719.                     FROM All Persons
  720.                     WHERE full contains "David"
  721.                     (or, WHERE given is "David"; take your pick....)
  722.  
  723.                But, what if you want to find all the people whose
  724.                FATHER's name was David?  To do this, use the FATHER
  725.                operand; anything after the FATHER operand can be any
  726.                operand that relates to persons.  Specifically:
  727.  
  728.                     MAKE David's Children
  729.                     FROM All Persons
  730.                     WHERE father full contains "David"
  731.  
  732.                Take a moment and reflect on the power of this simple
  733.                keyword.  I mean it.  Really.  Stop right now and give
  734.                it some thought.  You'll thank me for it.
  735.  
  736.                It means that you can search for anything about a
  737.                person's parents that you can search for about a person.
  738.                In fact, you can search for anything about a person's
  739.                parents' parents that you can search for about a person.
  740.                For example, to find all grandchildren of men named
  741.                David, use this command:
  742.  
  743.                     MAKE David's Grandchildren
  744.                     FROM All Persons
  745.                     WHERE father father full contains "David" or
  746.                           mother father full contains "David"
  747.  
  748.                For this reason, the FATHER keyword in the list below
  749.                has "Persons" after "Followed by:".  It means that when
  750.                you use the operand FATHER, you can follow it with any
  751.                person-related operand, such as BAPTISM DATE or PIN or
  752.                GIN or FIRST SPOUSE or whatever.
  753.  
  754.                Similarly, if "Followed by:" is followed by "Families",
  755.                such as is the case with the FAMILY operand, you can
  756.                follow that operand with any family-related operand.
  757.                This is important to understand, because a person's
  758.                marriage information is not accessible without it.  In
  759.                other words, "WHERE marriage date is missing" is legal
  760.                for families, but not for persons.  To get a person's
  761.                marriage date, use "WHERE any family marriage date is
  762.                missing".
  763.  
  764.                In this list, we add a new entry in the description
  765.                list, called "ANY/ALL Modifiers:"
  766.  
  767.                "ANY/ALL Modifiers:  Yes" means that any of the "ANY,
  768.                ALL, FIRST, NUMBER #, and LAST" modifiers, which were
  769.                discussed in the foregoing subsection (entitled
  770.                "Modifier Variables") can be used here.  Their use is
  771.                optional.
  772.  
  773.                "ANY/ALL Modifiers:  No" means that the ANY, ALL, FIRST,
  774.                NUMBER #, and LAST modifiers are meaningless in
  775.                connection with this operand.
  776.  
  777.                CHILD:
  778.                     List Type:  Families
  779.                     ANY/ALL Modifiers:  Yes
  780.                     Followed by:  Persons
  781.                     Meaning:  One, some, or all of the family's
  782.                               children, depending on which modifier
  783.                               precedes this one.
  784.                     Example:  WHERE any child afn is missing
  785.                     Notes:  When CHILD is not preceded by modifier such
  786.                             as ANY, ALL, etc., and when there are
  787.                             several children to choose from, GIM LISTS
  788.                             assumes the "progenitor" child; see chapter
  789.                             8 for details.
  790.  
  791.                FAMILY:
  792.                     List Type:  Persons
  793.                     ANY/ALL Modifiers:  Yes
  794.                     Followed by:  Families
  795.                     Meaning:  One, some, or all of the person's
  796.                               families, depending on which modifier
  797.                               precedes this one.
  798.                     Example:  WHERE family general source note contains "X"
  799.                     Notes:  When FAMILY is not preceded by a modifier
  800.                             such as ANY, ALL, etc., and when there are
  801.                             several to choose from, GIM LISTS assumes
  802.                             the "selected" spouse's family; see chapter
  803.                             4 for details.
  804.  
  805.                FATHER:
  806.                     List Type:  Persons or Families
  807.                     ANY/ALL Modifiers:  No
  808.                     Followed by:  Persons
  809.                     Meaning:  The person's father,
  810.                               or the family's husband
  811.                     Example:  WHERE surname isn't father surname
  812.                     Notes:  See also HUSBAND, which is a synonym for
  813.                             FATHER, but only when used for lists of
  814.                             families.
  815.  
  816.                HUSBAND:
  817.                     List Type:  Families
  818.                     ANY/ALL Modifiers:  No
  819.                     Followed by:  Person
  820.                     Meaning:  The family's husband
  821.                     Example:  WHERE husband gin ne 0
  822.                     Notes:  See also FATHER, which is a synonym for
  823.                             HUSBAND.
  824.  
  825.                MOTHER:
  826.                     List Type:  Persons or Families
  827.                     ANY/ALL Modifiers:  No
  828.                     Followed by:  Persons
  829.                     Meaning:  The person's mother,
  830.                               or the family's wife
  831.                     Example:  WHERE mother gin isn't 0
  832.                     Notes:  See also WIFE, which is a synonym for
  833.                             MOTHER, but only when used for lists of
  834.                             families.
  835.  
  836.                PARENTS:
  837.                     List Type:  Persons
  838.                     ANY/ALL Modifiers:  No
  839.                     Followed by:  Families
  840.                     Meaning:  The person's parents.
  841.                     Example:  WHERE parents marriage date isn't missing
  842.                     Notes:  To be consistent, PARENTS should take ANY
  843.                             and ALL modifiers, for persons with multiple
  844.                             sets of parents.  Look for this to be added
  845.                             in a future release.  For now, if there are
  846.                             multiple parents, only the "selected" or
  847.                             principal set of parents is used.
  848.  
  849.                SPOUSE:
  850.                     List Type:  Persons
  851.                     ANY/ALL Modifiers:  Yes
  852.                     Followed by:  Persons
  853.                     Meaning:  One, some, or all of the person's
  854.                               spouses, depending on which modifier
  855.                               precedes this one.
  856.                     Example:  WHERE spouse gin ne 0
  857.                     Notes:  When SPOUSE is not preceded by an operand,
  858.                             and when there are several to choose from,
  859.                             GIM LISTS assumes the "selected" spouse;
  860.                             see chapter 4 for details.
  861.  
  862.                WIFE:
  863.                     List Type:  Families
  864.                     ANY/ALL Modifiers:  No
  865.                     Followed by:  Person
  866.                     Meaning:  The family's wife
  867.                     Example:  WHERE wife gin ne 0
  868.                     Notes:  See also MOTHER, which is a synonym for
  869.                             WIFE.
  870.  
  871. THE DIAGRAM...
  872.  
  873.           If you've followed me so far -- which I admit is not an easy
  874.           feat! -- the following diagram should help to put all of the
  875.           pieces together.  If it's not completely obvious and clear to
  876.           you, after you've read the foregoing discussion, please let me
  877.           know what doesn't make sense.
  878.  
  879.  
  880.  
  881. GLOBAL ABBREVIATIONS:
  882.  
  883. ┌───┐     ┌          ┐      ┌───┐     ┌          ┐     ┌      ┐
  884. │ A │ ──> │ DATE     │      │ C │ ──> │ SOURCE   │ ──> │      │
  885. └───┘     │ PLACE    │      └───┘     │ RESEARCH │     │      │
  886.           │ PLACEBEG │                └          ┘     │      │
  887.           │ PLACEEND │                                 │ NOTE │
  888.           └          ┘                       ┌───┐     │      │
  889.                                              │ B │ ──> │      │
  890.                                              └───┘     │      │
  891.                                                        └      ┘
  892.  
  893. < ... > == nothing, meaning only, or skip if none, or selected (p.select
  894.            for spouses or f.progenitor for children) if multiple
  895.  
  896. CONSTRUCTIONS FOR PERSONS:
  897.  
  898.                            ┌       ┐
  899.                ┌     ┐     │ VITAL │     ┌   ┐
  900.           ┌──> │ ANY │ ──> │ LDS   │ ──> │ A │
  901.           │    │ ALL │     └       ┘     │ B │
  902.           │    └     ┘ ────────────────> │ C │
  903.           │                              └   ┘
  904.           │                                      ┌   ┐
  905.           │                     ┌          ┐     │ A │
  906.           │                     │ MARRIAGE │ ──> │ B ┼> { B only if ANY or ALL }
  907.           │    ┌          ┐ ──> │ SEALSP   │     │ C │
  908.           │    │ ANY      │     └          ┘     └   ┘
  909.           │    │ ALL      │     ┌        ┐
  910.           ├──> │ FIRST    │ ──> │ FAMILY │ ──> Family
  911.           │    │ < ... >  │     └        ┘
  912.           │    │ NUMBER # │     ┌        ┐
  913.           │    │ LAST     │ ──> │ SPOUSE │ ──> Person
  914.           │    └          ┘     └        ┘
  915.           │
  916.           │    ┌         ┐     ┌   ┐
  917.           ├──> │ GENERAL │ ──> │ C │
  918.           │    └         ┘     └   ┘
  919.           │
  920.           │    ┌        ┐
  921. Person ───┼──> │ FATHER │ ──> Person
  922.           │    │ MOTHER │
  923.           │    └        ┘
  924.           │
  925.           │    ┌         ┐
  926.           ├──> │ PARENTS │ ──> Family
  927.           │    └         ┘
  928.           │
  929.           │    ┌         ┐
  930.           │    │ BIRTH   │
  931.           ├──> │ CHR     │     ┌   ┐
  932.           │    │ DEATH   │     │ A │
  933.           │    │ BURIAL  │ ──> │   │
  934.           │    │ BAPT    │     │ C │
  935.           │    │ ENDOW   │     └   ┘
  936.           │    │ SEALPAR │
  937.           │    └         ┘
  938.           │
  939.           │    ┌                 ┐
  940.           │    │ AFN             │
  941.           │    │ REFN            │
  942.           │    │ PIN             │
  943.           │    │ GIN             │
  944.           │    │ FIRST or GIVEN  │
  945.           │    │ LAST or SURNAME │
  946.           │    │ FULL            │
  947.           └──> │ CODE            │
  948.                │ NUMPARENTS      │
  949.                │ NUMPARENTSETS   │
  950.                │ SPOUSES         │
  951.                │ CHILDREN        │
  952.                │ GENDER          │
  953.                └                 ┘
  954.  
  955. CONSTRUCTIONS FOR FAMILIES:
  956.  
  957.                            ┌   ┐
  958.                ┌     ┐     │ A │
  959.           ┌──> │ ANY │ ──> │ B │
  960.           │    │ ALL │     │ C │
  961.           │    └     ┘     └   ┘
  962.           │
  963.           │    ┌          ┐
  964.           │    │ ANY      │
  965.           │    │ ALL      │     ┌        ┐
  966.           ├──> │ FIRST    │ ──> │ CHILD  │ ──> Person
  967.           │    │ < ... >  │     └        ┘
  968.           │    │ NUMBER # │
  969.           │    │ LAST     │
  970.           │    └          ┘
  971.           │
  972.           │    ┌         ┐     ┌   ┐
  973. Family ───┼──> │ GENERAL │ ──> │ C │
  974.           │    └         ┘     └   ┘
  975.           │
  976.           │    ┌         ┐
  977.           │    │ FATHER  │
  978.           ├──> │ HUSBAND │ ──> Person
  979.           │    │ MOTHER  │
  980.           │    │ WIFE    │
  981.           │    └         ┘
  982.           │
  983.           │                     ┌   ┐
  984.           │    ┌          ┐     │ A │
  985.           ├──> │ MARRIAGE │ ──> │   │
  986.           │    │ SEALSP   │     │ C │
  987.           │    └          ┘     └   ┘
  988.           │
  989.           │    ┌          ┐
  990.           │    │ FIN      │
  991.           └──> │ CHILDREN │
  992.                └          ┘
  993.  
  994. CONSTRUCTIONS FOR NOTES:
  995.  
  996.                ┌   ┐
  997. Note   ──────> │ B │
  998.                └   ┘
  999.